<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<title>ClipWait</title>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<link href="../css/default.css" rel="stylesheet" type="text/css">
</head>
<body>

<h1>ClipWait</h1>

<p>等待, 一直到 <a href="../misc/Clipboard.htm">剪贴板</a> 包含数据.</p>

<pre class="Syntax">ClipWait [, SecondsToWait, 1]</pre>
<h3>参数</h3>
<table class="info">
  <tr> 
    <td width="15%">SecondsToWait</td>
    <td width="85%">如果省略, 此命令将无限期等待. 否则, 它将等待不超过这个秒数的时间 (可以包含小数点或为 <a href="../Variables.htm#Expressions">表达式</a>). 指定 0 等同于指定 0.5.</td>
  </tr>
  <tr>
    <td>1<br>    </td>
    <td>如果省略此参数, 此命令会更有选择性, 明确地等待剪贴板中出现文本或文件 ("文本" 包含任何当您粘贴到记事本时会产生文本的内容). 如果此参数为 1 (可以为 <a href="../Variables.htm#Expressions">表达式</a>), 此命令会等待剪贴板中出现任何类型的数据.</td>
  </tr>
</table>

<h3>ErrorLevel</h3>
<p>如果到达等待期限, <a href="../misc/ErrorLevel.htm">ErrorLevel</a> 将被置为 1. 否则 (即剪贴板包含数据), ErrorLevel 被置为 0.</p>
<h3>备注</h3>
<p>使用此命令比您在一个循环中检查剪贴板是否为空要好. 这是由于此命令从不打开剪贴板, 因此执行地更好并且避免了对可能使用剪贴板的其他程序的干扰.</p>
<p>此命令把任何可转换成文本的内容 (例如 HTML) 视为文本. 它也把文件, 例如从资源管理器窗口中通过 Control-C 复制的那些, 视为文本. 每当在脚本中引用剪贴板变量 (%clipboard%) 时, 这些文件被自动转换成它们的文件名 (包含完整路径). 详情见 <a href="../misc/Clipboard.htm">剪贴板</a>.</p>
<p>当最后一个参数为 1 时, 剪贴板中出现任何数据都将符合此命令. 这种特性可以和 <a href="../misc/Clipboard.htm#ClipboardAll">ClipboardAll</a> 结合使用来保存像图片这样的非文本数据.</p>
<p>当此命令处于等待状态时, 可以通过 <a href="../Hotkeys.htm">热键</a>, <a href="Menu.htm">自定义菜单项</a> 或 <a href="SetTimer.htm">计时器</a> 运行新的 <a href="../misc/Threads.htm">线程</a>.</p>
<h3>相关</h3>
<p><a href="../misc/Clipboard.htm">Clipboard</a>, <a href="WinWait.htm">WinWait</a>, <a href="KeyWait.htm">KeyWait</a> </p>
<h3>示例</h3>
<pre class="NoIndent">clipboard = <em>; 清空剪贴板</em>
Send, ^c
ClipWait, 2
if ErrorLevel
{
    MsgBox, The attempt to copy text onto the clipboard failed.
    return
}
MsgBox, clipboard = %clipboard%
return</pre>

</body>
</html>
